Node / meshtastic / Meshtastic-Android / files / feature / map / README.md

Displaying Raw • View rendered • Download

Tc9d1d9# `:feature:map`

Tc9d1d9## Overview

The Ta5d6ff`:feature:map` module provides the mapping interface for the application. It supports multiple map providers and displays node positions, tracks, and waypoints.

Tc9d1d9## Key Components

Tc9d1d9### 1. `MapScreen`

The main mapping interface. It integrates with flavor-specific map implementations (Google Maps for Ta5d6ff`google`, OpenStreetMap for Ta5d6ff`fdroid`).

Tc9d1d9### 2. `BaseMapViewModel`

The base logic for managing map state, node markers, and camera positions.

Tc9d1d9## Map Providers

Tff7b72- **Google Maps (`google` flavor)**: Uses Google Play Services Maps SDK.

Tff7b72- **OpenStreetMap (`fdroid` flavor)**: Uses Ta5d6ff`osmdroid` for a fully open-source mapping experience.

Tc9d1d9## Features

Tff7b72- **Live Node Tracking**: Real-time position updates for nodes on the mesh.

Tff7b72- **Waypoints**: Create and share points of interest.

Tff7b72- **Offline Maps**: Support for pre-downloaded map tiles (via Ta5d6ff`osmdroid`).

Tc9d1d9## Module dependency graph

<!--region graph-->

Ta5d6ff```Ta5d6ffmermaid

Ta5d6ffgraph TB

:feature:map[map]:::kmp-feature

classDef android-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;

classDef android-application-compose fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;

classDef compose-desktop-application fill:#CAFFBF,stroke:#000,stroke-width:2px,color:#000;

classDef android-feature fill:#FFD6A5,stroke:#000,stroke-width:2px,color:#000;

classDef android-library fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;

classDef android-library-compose fill:#9BF6FF,stroke:#000,stroke-width:2px,color:#000;

classDef android-test fill:#A0C4FF,stroke:#000,stroke-width:2px,color:#000;

classDef jvm-library fill:#BDB2FF,stroke:#000,stroke-width:2px,color:#000;

classDef kmp-feature fill:#FFD6A5,stroke:#000,stroke-width:2px,color:#000;

classDef kmp-library-compose fill:#FFC1CC,stroke:#000,stroke-width:2px,color:#000;

classDef kmp-library fill:#FFC1CC,stroke:#000,stroke-width:2px,color:#000;

classDef unknown fill:#FFADAD,stroke:#000,stroke-width:2px,color:#000;

Ta5d6ff```

<!--endregion-->